home *** CD-ROM | disk | FTP | other *** search
/ Power Tools 1993 October - Disc 1 / Power Tools (Disc 1)(October 1993)(HP).iso / spec / a3821345 / a3821345.txt < prev    next >
Text File  |  1993-08-18  |  18KB  |  376 lines
  1. HP LU 6.2 Application Programming Interface, Technical Data
  2.   For HP 3000 V or iX Computer Systems
  3. Product Numbers 30253A and 30294A
  4.   This data sheet describes HP LU 6.2 API (Application Programming
  5. Interface) for both MPE V and MPE iX operating systems.  The term
  6. HP LU 6.2 API is used to refer to both HP LU 6.2 API/V and HP LU 6.2
  7. API/iX products.  The terms HP LU 6.2 API/V and HP LU 6.2 API/iX are
  8. used when a distinction is necessary.
  9.  
  10. [Figure: , Caption: none]
  11.  
  12. HP LU 6.2 API/V on an HP 3000 Series 37 through 70 or HP LU 6.2 API/iX
  13. on an HP 3000 Series 9xx provides HP 3000 users with a way to program
  14. HP 3000 application programs for program-to-program communication in an
  15. SNA environment.
  16.   HP LU 6.2 API implements the LU 6.2 "mapped conversation verbs" for
  17. what IBM has named "advanced program-to-program communications" (APPC).
  18. Users may write "transaction programs" that use these verbs (or
  19. high-level intrinsics as HP has implemented them) in order to
  20. communicate with each other, even though these programs may be executing
  21. on different systems within the SNA network.
  22.  
  23. Features
  24. HP LU 6.2 API provides:
  25. o High-level Intrinsics: HP 3000 programmers can use a set of high-level
  26.   intrinsics to implement program-to-program communication in an SNA
  27.   network.
  28. o Support for Major Languages: Application programs on the HP 3000 can
  29.   be written in COBOL II, Transact, or Pascal.  For LU 6.2 API/iX, C
  30.   language applications are also supported.
  31. o Support for IBM Applications: HP LU 6.2 API supports Mapped
  32.   Conversations with CICS in an MVS or DOS/VSE environment and Mapped
  33.   Conversations with VTAM in an MVS environment.  With MPE iX Release
  34.   4.0 or later, HP LU 6.2 API/iX supports Mapped Conversations in an
  35.   OS/400 environment.
  36. o Multiple Sessions: An HP 3000 application program using LU 6.2 API/V
  37.   intrinsics may have up to 8 LU-LU sessions running simultaneously.
  38.   With MPE iX Release 4.0 or later, an HP 3000 application program using
  39.   LU 6.2 API/iX intrinsics may have up to 256 LU-LU sessions running
  40.   simultaneously.  Each session is responsible for a separate
  41.   communication task or for adding additional bandwidth to a single
  42.   communication task.
  43. o Peer-to-Peer Connectivity:  With MPE iX Release 4.0 or later, LU 6.2
  44.   API/iX provides peer-to-peer connectivity to an IBM AS/400 over Node
  45.   Type 2.1.  an HP 3000 may establish LU-LU sessions with an IBM AS/400
  46.   over Node Type 2.1 without having to go through a mainframe node.
  47. o Parallel Sessions:  With MPE iX Release 4.0 or later, LU 6.2 API/iX
  48.   provides support for parallel sessions over Node Type 2.1.  An HP 3000
  49.   may establish multiple, simultaneous LU-LU sessions over a single LU-
  50.   LU pair over Node Type 2.1.
  51. o Support for Remote Attach: Remote Attach is the ability of a remote
  52.   LU 6.2 application to request an HP 3000 LU 6.2 application to start
  53.   running and begin communication with it.
  54. o Compatibility with Other SNA Services: The HP LU 6.2 API is completely
  55.   compatible with other SNA services offered for the HP 3000 such as SNA
  56.   Interactive Mainframe Facility (SNA IMF), SNA Network Remote Job Entry
  57.   (SNA NRJE), and SNA Distributed Host Command Facility/iX (SNA
  58.   DHCF/iX).  These products may all be running simultaneously over the
  59.   same SNA Link/V, SNA/SDLC Link/iX, or SNA/X.25 Link/iX to the SNA
  60.   network.  The SNA Link products manage the physical link to the IBM
  61.   host and implement protocols in the lower three layers of SNA.
  62. Note:  HP LU 6.2 API/iX supports Native-mode HP 3000 applications only.
  63. o Trace Facility: An easy-to-use trace facility that allows HP 3000
  64.   application programmers to track all LU 6.2 intrinsic calls and
  65.   executions within applications being developed, serving as a valuable
  66.   debugging aid during program development.
  67. o Logging Facility: A comprehensive logging facility that records all
  68.   online LU 6.2 API session messages to aid in problem identification
  69.   and resolution.
  70. o User Controlled Sessions Management from Program or CI (CNOS):  With
  71.   MPE iX Release 4.0 or later, Programmatic or interactive user-
  72.   controlled session management allows users to change session limits
  73.   (over Node Type 2.1).
  74. o Enhanced Communication Rates: The maximum datacom line speed between
  75.   the HP 3000 and the IBM mainframe host is 56 Kbps on MPE/V and 64 Kbps
  76.   on MPE/iX.
  77. o Efficient and easy-to-program problem detection and recovery
  78.   procedures.
  79. o As with all HP SNA services, customizable error and help facilities
  80.   are provided.
  81. o X.25 Connectivity:  HP LU 6.2 API/iX can communicate to an IBM
  82.   mainframe over an X.25 connection.  The SNA/X.25 Link/iX product
  83.   (HP 30298A) can be used in place of SNA/SDLC Link/iX, but SNA/X.25
  84.   Link/iX emulates a Type 2.0 node, not a Type 2.1 node.  Therefore if
  85.   you run LU 6.2 API/iX over SNA/X.25 Link/iX, you cannot communicate,
  86.   peer-to-peer with a Type 2.1 node like an IBM AS/400.
  87.  
  88. Functional Description
  89. HP LU 6.2 API provides a set of high-level intrinsics for application
  90. programmers to use for program-to-program communication between an
  91. HP 3000 application program and an application program running on an IBM
  92. host mainframe.  HP LU 6.2 API/iX also provides communication to an IBM
  93. AS/400.  These intrinsics are responsible for initiating LU 6.2
  94. conversations so that data can be sent or received over these
  95. conversations on behalf of program pairs needing to communicate to
  96. complete a "transaction." Examples of transactions are database updates
  97. and file transfers.  LU 6.2 API consists of a set of user-callable
  98. intrinsics that implement the set of LU 6.2 defined mapped verbs along
  99. with the following option sets:
  100.  
  101. LU 6.2 API intrinsics are summarized in the following table.
  102.  
  103. LU 6.2 API Intrinsics Summary
  104. ------------------------------------------------------------------------
  105. Intrinsics          Function
  106. ----------------------------------------------------------------------
  107. MCALLOCATE          Establishes a mapped conversation between two TPs.
  108. ----------------------------------------------------------------------
  109. MCCONFIRM           Sends a confirmation request to the remote TP and
  110.                     waits for a reply.
  111. ----------------------------------------------------------------------
  112. MCCONFIRMED         Sends a confirmation reply to the remote TP in
  113.                     response to receiving a confirmation request.
  114. ----------------------------------------------------------------------
  115. MCDEALLOCATE        Ends a mapped conversation between TPs.
  116. ----------------------------------------------------------------------
  117. MCGETALLOCATE       Receives the request from a remote TP to start a
  118.                     conversation and then establishes the conversation.
  119. ----------------------------------------------------------------------
  120. MCGETATTR           Returns information pertaining to a mapped
  121.                     conversation.
  122. ----------------------------------------------------------------------
  123. MCFLUSH             Flushes the LU's send buffer.
  124. ----------------------------------------------------------------------
  125. MCPOSTONRCPT        Causes LU 6.2 API to post the conversation when
  126.                     information arrives.
  127. ----------------------------------------------------------------------
  128. MCPREPTORCV         Informs the remote TP that the HP 3000 resident TP
  129.                     (the local TP) is ready to receive data over the
  130.                     mapped conversation.
  131. ----------------------------------------------------------------------
  132. MCRCVANDWAIT        Waits for information to arrive on the mapped
  133.                     conversation and then receives the information.  The
  134.                     information can be data, conversation status, or
  135.                     request for confirmation.
  136. ----------------------------------------------------------------------
  137. MCRCVNOWAIT         Receives any information available on the mapped
  138.                     conversation without waiting.
  139. ----------------------------------------------------------------------
  140. MCREQTOSEND         Notifies the remote TP that the local TP is
  141.                     requesting to send data for the mapped conversation.
  142. ----------------------------------------------------------------------
  143. MCSENDDATA          Sends data to the remote TP.
  144. ----------------------------------------------------------------------
  145. MCSENDERROR         Informs the remote TP that the local TP has detected
  146.                     an error.
  147. ----------------------------------------------------------------------
  148. MCTEST              Tests the conversation for the receipt of
  149.                     information.
  150. -----------------------------------------------------------------------
  151. MCWAIT              Waits for the receipt of information on one or more
  152.                     conversations.
  153. ------------------------------------------------------------------------
  154.  
  155.  
  156. ------------------------------------------------------------------------
  157. Option Sets                                       IBM-Defined Verbs
  158. ------------------------------------------------------------------------
  159. o PIP data (both local and remote support)
  160. o Flush the LU's send buffer                      MC_FLUSH
  161. o Prepare to receive (including long locks)       MC_PREPARE_TO_RECEIVE
  162. o Post on receipt                                 MC_POST_ON_RECEIPT
  163. o Wait for posting to occur                       WAIT
  164. o Test for posting or request-to-send received    MC-TEST
  165. o Receive immediate                               MC_RECEIVE_IMMEDIATE
  166. o Get conversation attributes                     MC_GET_ATTRIBUTES
  167. ------------------------------------------------------------------------
  168. Product Requirements
  169. Requirements for IBM mainframe hardware and software are the same for
  170. both HP LU 6.2 API/V and HP LU 6.2 API/iX.
  171.  
  172. IBM Mainframe Hardware Requirements:
  173. o An IBM System/370 mainframe.  This may be any IBM plug-compatible
  174.   mainframe that supports 370 architecture.
  175. o A port on an IBM 37xx or compatible communications controller that
  176.   supports an SNA line.  The HP 3000 can also be connected to the
  177.   Communications Controller via an IBM 3710 Network Controller.  (Please
  178.   check with your HP Sales Representative for specific Communication
  179.   Controller model support.)
  180.  
  181. IBM Mainframe Software Requirements:
  182. o Advanced Communication Function for the Virtual Telecommunications
  183.   Access Method (ACF/VTAM) applications are supported with:
  184.   - Mapped LU 6.2 conversations only
  185.   - ACF/VTAM version 3.2 or later
  186.   - MVS operating system
  187. o Advanced Communication Function for the Network Control Program
  188.   (ACF/NCP) remote transmission control program version 3.1 or later.
  189. o Customer Information Control System (CICS) applications are supported
  190.   with:
  191.   - Mapped LU 6.2 conversations only
  192.   - CICS version 1.7 or later
  193.   - ACF/VTAM version 2.1 or later
  194.   - MVS or DOS/VSE operating system
  195.  
  196. IBM AS/400 Hardware Requirements:
  197. o An IBM AS/400.
  198. o A port on the AS/400 that supports an SNA line.
  199.  
  200. IBM AS/400 Software Requirements:
  201. o OS/400 Version 1.2 or later.
  202.  
  203. HP 3000 product requirements:
  204. o For HP LU 6.2 API/V:
  205.   An HP 3000 Series 37-70 computer system, the MPE V operating system,
  206.   and the SNA Link/V product (HP 30246A).
  207. o For HP LU 6.2 API/iX:
  208.   If connecting to an IBM mainframe:  An HP 3000 Series 900 running MPE
  209.   XL Release 2.2 or MPE iX Release 4.0 or later operating system.  The
  210.   SNA/SDLC Link/iX product (HP 30291A) or the SNA/X.25 Link/ix product
  211.   (HP 30298A).
  212. If connecting to an IBM AS/400:  An HP 3000 Series 900 running MPE iX
  213. Release 4.0 or later operating system.  The SNA/SDLC Link/iX product
  214. (HP 30291A).
  215. o A full- or half-duplex data communications line (switched or leased)
  216.   between the HP 3000 and the IBM mainframe or IBM AS/400.  A pair of
  217.   synchronous modems.
  218.   - or -
  219.   An X.25 connection to the IBM mainframe (X.25 not supported to IBM
  220.   AS/400).
  221. o A block mode terminal that is supported by VPLUS/3000 for
  222.   configuration.
  223. o A COBOL II, PASCAL, C (HP LU 6.2 API/iX only), or Transact compiler.
  224.  
  225. Installation and Configuration Policy
  226. The customer is responsible for loading the HP LU 6.2 API software onto
  227. the system.
  228.   Hewlett-Packard will perform minimum configuration of HP LU 6.2 API in
  229. order to verify minimum product functionality.  This activity is
  230. included in the product purchase price.
  231.  
  232. Customer Responsibility
  233. The customer is responsible for performing the following tasks in order
  234. to successfully install and configure HP LU 6.2 API:
  235. o Providing HP with the information necessary to complete the Network
  236.   Implementation and Support Plan (NISP), including:
  237.   - System configurations
  238.   - Logical network map identifying relevant traffic flow
  239.   - Physical network map identifying relevant network hardware
  240.     components.
  241. o Verifying that the necessary host mainframe or AS/400 software is
  242.   installed and configured to support HP LU 6.2 API.  The customer
  243.   should consult the "HP SNA Products: ACF/NCP and ACF/VTAM Guide"
  244.   (P/N 5958-8543), the "HP SNA Products: CICS Guide" (P/N 5958-8546), or
  245.   the "HP SNA Products:  AS/400 Guide" (P/N 5960-1629) for details.
  246. o Verifying that SNA Link/V, SNA/SDLC Link/iX, or SNA/X.25 Link/iX is
  247.   properly installed and configured prior to the installation of
  248.   HP LU 6.2 API.
  249. o Updating the HP 3000 system to the proper release level and installing
  250.   the HP LU 6.2 API software using AUTOINST.  Refer to the HP 3000
  251.   MPE iX Installation and Update Manual (36123-90001) for MPE iX systems
  252.   or the HP 3000 Software Update Manual (32033-90036) for MPE V systems.
  253. o Verifying that all of the necessary software modules have been
  254.   successfully installed by AUTOINST and are at the correct version
  255.   levels using the NMMAINT.PUB.SYS utility.
  256. o Configuring HP LU 6.2 API in order to fully integrate HP LU 6.2 API
  257.   into the existing customer network.
  258.  
  259. HP Responsibility
  260. Following the installation of HP LU 6.2 API, HP is responsible for the
  261. following:
  262. o Confirming that all of the necessary software modules have been
  263.   installed and are at the correct version level.
  264. o Configuring 1 LU with 'Unsolicited Bind' equal to 'Y'.
  265. o Starting the APPC subsystem and verifying that the LU is in a PENDING
  266.   or ACTIVE state.
  267.  
  268. These steps complete HP's portion of the installation and minimum
  269. configuration of HP LU 6.2 API.
  270.  
  271. Additional Implementation Assistance
  272. For implementation needs that go beyond installation, the customer can
  273. either provide self-support, or can purchase additional services from
  274. HP.  These services include Network Startup and HP ConsultLine.  In
  275. addition, the customer can also purchase service from HP on a
  276. time-and-materials basis.
  277.   Network Startup includes implementation scheduling and coordination
  278. assistance, network configuration and verification testing, and network
  279. documentation.
  280.  
  281. Ordering Information
  282.   HP LU 6.2 API/V:
  283. 30253A License to use
  284.  
  285. Select one processor option.  Upgrade credits may be used where
  286. applicable.
  287.   Processor Options:
  288. 310  For Series 37, 37XE, or MICROs
  289. 320  For Series 39 through 58
  290. 330  For Series 64 through 70
  291. In order to receive the upgrade credit, customers must select the
  292. upgrade credit option that pertains to their current processor option in
  293. addition to the new processor option on the same order.
  294.  
  295. Upgrade Credit Options:
  296. OCD  Upgrade credit for Option 310
  297. OCE  Upgrade credit for Option 320
  298.  
  299. HP LU 6.2 API/iX:
  300. 30294A License to use
  301.  
  302. Select one User License Option.  The User License Option must align with
  303. the MPE iX License.  Upgrade credits may be used where applicable.
  304.   User License Options:
  305. OAF  20-user license
  306. UCY  40-user license
  307. UA9  64-user license
  308. UBD  100-user license
  309. UCN  160-user license
  310. UAT  Unlimited user license
  311. In order to receive the upgrade credit, customers must select the
  312. upgrade credit option that pertains to their current processor/user
  313. license option in addition to the new user license option on the same
  314. order.
  315.  
  316. Upgrade Credit Options:
  317. UD8  Credit for 20-user license
  318. UCZ  Credit for 40-user license
  319. UB9  Credit for 64-user license
  320. UD9  Credit for 100-user license
  321. UDV  Credit for 160-user license
  322. UBP  Credit for Unlimited user license
  323. OCD  For Processor Option 310
  324. OGJ  For Processor Option 315
  325. OCE  For Processor Option 320
  326. OCF  For Processor Option 330
  327. OGL  For Processor Option 335
  328. OGM  For Processor Option 340
  329. UEK  For Processor Option 350
  330. In order to receive the upgrade credit, customers must order the
  331. migration credit option in addition to the new MPE iX software option on
  332. the same order.
  333.  
  334. Migration Credit Options for MPE V software to MPE iX software upgrades:
  335. OG1  For MPE V software Option 310
  336. OG2  For MPE V software Option 320
  337. OG3  For MPE V software Option 330
  338.  
  339. Note:  Ordering information for HP 30246A SNA Link/V, HP 30291A SNA
  340. Link/iX, and HP 30298A SNA/X.25 Link/iX may be found in this guide under
  341. their respective data sheets.
  342.  
  343. Support Products
  344. HP offers a spectrum of support service products to help plan,
  345. implement, operate, and manage your multivendor network throughout the
  346. network lifecycle.
  347.   For more information, contact your HP Sales Representative, or refer
  348. to the HP data sheets for specific support services.
  349.  
  350. Documentation
  351.   For both HP LU 6.2 API/V and HP LU 6.2 API/iX:
  352. 5958-8542 HP SNA Products: Manager's Guide
  353. 5958-8543 HP SNA Products: ACF/NCP and ACF/VTAM Guide
  354. 5958-8646 HP SNA Products: CICS Guide
  355. 30294-61000 HP LU 6.2 API:  Application Programmer's Reference Manual
  356.  
  357. For HP LU 6.2 API/iX:
  358. 5960-1629 HP SNA Products:  AS/400 Guide
  359. 30294-61002 APPC Subsystem on MPE iX Node Manager's Guide
  360.  
  361. For HP LU 6.2 API/V:
  362. 30253-90002 LU 6.2 API/V Node Manager's Guide
  363. 30253-90004 APPC Subsystem on MPE V Node Manager's Guide
  364.  
  365. For SNA Link/iX:
  366. 30291-61000 SNA Link/iX Node Manager's Guide
  367.  
  368. For SNA Link/V:
  369. 30246-90002 Getting Started with SNA Node Management
  370. 30246-90003 SNA Link Services Reference Manual
  371.  
  372. From HP Networking Communications Specification Guide, 5091-3821E, 9205
  373.   modified 9307, p
  374. Associated files:  la3821x5.plt, la3821x5.gal, a3821345.doc
  375. HP LU 6.2 Application Programming Interface, Technical Data
  376.